---
title: Installa Astro con la CLI Automatica
description: Come installare Astro con NPM, PNPM, o Yarn tramite lo strumento CLI create-astro.
i18nReady: true
---
import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'


Pronto/a per installare Astro? Segui questa guida all'uso del comando CLI `create astro` per iniziare.

:::note[Preferisci installare Astro manualmente?]
Leggi invece la nostra [guida passo per passo all'installazione manuale](/it/install/manual/).
:::
#### Prerequisiti

- **Node.js** - `v18.14.1` o superiore.
- **Editor di testo** - Raccomandiamo [VS Code](https://code.visualstudio.com/) con la nostra [Estensione Ufficiale Astro](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode).
- **Terminale** - Astro viene utilizzato tramite la sua interfaccia da riga di comando (CLI).

#### Installazione

Il comando `create astro` è il modo più rapido per iniziare un nuovo progetto Astro partendo da zero. Ti guiderà ad ogni passo per impostare il tuo nuovo progetto Astro. Ti permette di scegliere tra diversi template ufficiali già pronti oppure puoi [usare qualunque progetto esistente su GitHub con l'argomento `--template`](#template-di-partenza).

:::tip[Anteprime online]
Preferisci provare Astro nel tuo browser? Visita [astro.new](https://astro.new/) per esplorare i nostri template e creare un nuovo progetto Astro senza mai lasciare il tuo browser.
:::

## 1. Esegui lo strumento di setup

Esegui il seguente comando nel tuo terminale per eseguire il nostro utile strumento di installazione:

<PackageManagerTabs>
  <Fragment slot="npm">
  ```shell
  # crea un nuovo progetto con npm
  npm create astro@latest
  ```
  </Fragment>
  <Fragment slot="pnpm">
  ```shell
  # crea un nuovo progetto con pnpm
  pnpm create astro@latest
  ```
  </Fragment>
  <Fragment slot="yarn">
  ```shell
  # crea un nuovo progetto con yarn
  yarn create astro
  ```
  </Fragment>
</PackageManagerTabs>

Puoi eseguire il comando `create astro` ovunque nel tuo computer, perciò non serve creare una nuova cartella vuota per il tuo progetto prima di cominciare. Se ancora non hai una cartella vuota per il tuo progetto, lo strumento ne creerà automaticamente una al tuo posto.

Se tutto va bene, dovresti vedere il messaggio "Liftoff confirmed. Explore your project!" ("Decollo confermato. Esplora il tuo progetto!") seguito da alcuni suggerimenti per i prossimi passi. Entra nella nuova cartella del tuo progetto con il comando `cd` per iniziare ad usare Astro.

Se hai saltato il comando `npm install` durante l'esecuzione dello strumento CLI, allora assicurati di installare le dipendenze prima di continuare.

## 2. Fai partire Astro ✨

Astro arriva con un server di sviluppo integrato che ha tutto il necessario per lo sviluppo del tuo progetto. Il comando `astro dev` farà partire il server di sviluppo locale così che tu possa vedere il tuo sito in azione per la primissima volta.

Ogni template ufficiale arriva con uno script preconfigurato che eseguirà il comando `astro dev` al posto tuo. Usa il tuo package manager preferito per eseguire questo comando e lanciare il server di sviluppo locale di Astro.

<PackageManagerTabs>
  <Fragment slot="npm">
  ```shell
  npm run dev
  ```
  </Fragment>
  <Fragment slot="pnpm">
  ```shell
  pnpm run dev
  ```
  </Fragment>
  <Fragment slot="yarn">
  ```shell
  yarn run dev
  ```
  </Fragment>
</PackageManagerTabs>


Se tutto va bene, ora Astro dovrebbe servire il tuo progetto all'indirizzo [http://localhost:4321/](http://localhost:4321/)!

Astro osserverà ogni cambiamento ai file nella cartella `src/`, perciò non dovrai far ripartire il server ad ogni modifica nel progetto durante lo sviluppo.

Quando visualizzi il tuo sito nel browser, avrai accesso alla [barra degli strumenti di sviluppo Astro](/it/guides/dev-toolbar/).  Mentre costruisci, ti aiuterà a ispezionare le tue [Isole](/it/concepts/islands/), identificare problemi di accessibilità e altro ancora.

Se non riesci ad aprire il tuo progetto nel browser, torna al terminale dove hai eseguito il comando `dev` e controlla se c'è stato un errore, o se il tuo progetto viene servito ad un indirizzo diverso da quello indicato precedentemente.

## Template di partenza

Puoi anche iniziare un nuovo progetto Astro partendo da un [esempio ufficiale](https://github.com/withastro/astro/tree/main/examples) o dal ramo `main` di una qualunque repository di GitHub passando l'argomento `--template` al comando `create astro`.

<PackageManagerTabs>
  <Fragment slot="npm">
  ```shell
  # crea un nuovo progetto con un esempio ufficiale
  npm create astro@latest -- --template <nome-di-esempio>

  # crea un nuovo progetto partendo dal ramo main di una repository di GitHub
  npm create astro@latest -- --template <github-username>/<github-repo>
  ```
  </Fragment>
  <Fragment slot="pnpm">
  ```shell
  # crea un nuovo progetto con un esempio ufficiale
  pnpm create astro@latest --template <nome-di-esempio>
  
  # crea un nuovo progetto partendo dal ramo main di una repository di GitHub
  pnpm create astro@latest --template <github-username>/<github-repo>
  ```
  </Fragment>
  <Fragment slot="yarn">
  ```shell
  # crea un nuovo progetto con un esempio ufficiale
  yarn create astro --template <nome-di-esempio>
  
  # crea un nuovo progetto partendo dal ramo main di una repository di GitHub
  yarn create astro --template <github-username>/<github-repo>
  ```
  </Fragment>
</PackageManagerTabs>

Questo comando userà di default il ramo `main` della repository. Per usare un altro ramo specificalo come parte dell'argomento `--template`: `<github-username>/<github-repository>#<ramo>`.

Esplora la vetrina dei nostri [temi e starter](https://astro.build/themes/) dove puoi trovare temi per blog, portfolio, documentazione, pagine di marketing, e altri ancora! O [cerca su GitHub](https://github.com/search?o=desc&q=astro+starter&s=stars&type=Repositories) per ancora più progetti starter.

## Prossimi passi

Evviva! Ora sei pronto/a a costruire siti e applicazioni con Astro! 🥳

Ecco alcuni argomenti che ti consigliamo di esplorare ora. Li puoi leggere in ordine sparso. Puoi anche uscire dalla nostra documentazione per un po' e andare a provare la codebase del tuo nuovo progetto Astro, e tornare qua se dovessi avere problemi o domande.

import { CardGrid, LinkCard } from '@astrojs/starlight/components';

<CardGrid>
  <LinkCard
    title="Comprendi il tuo codice"
    description="Scopri di più sulla struttura dei file Astro nella nostra guida Struttura del Progetto."
    href="/it/basics/project-structure/"
  />
  <LinkCard
    title="Aggiungi un framework"
    description="Estendi Astro con il supporto per React, Svelte, Tailwind e altro nella nostra guida alle Integrazioni."
    href="/it/guides/integrations-guide/"
  />
  <LinkCard
    title="Distribuisci il tuo sito"
    description="Impara come costruire e distribuire un progetto Astro sul web nella nostra guida alla Distribuzione."
    href="/it/guides/deploy/"
  />
</CardGrid>
